package com.mazaiting.manager.service;

import com.baomidou.mybatisplus.extension.service.IService;
import com.mazaiting.common.core.ex.exceptions.BaseException;
import com.mazaiting.common.core.ex.exceptions.BusinessException;
import com.mazaiting.common.core.ex.exceptions.EmptyObjectException;
import com.mazaiting.manager.domain.entity.SysPermission;
import com.mazaiting.manager.domain.form.PermForm;
import com.mazaiting.manager.domain.query.PermPageQuery;
import com.mazaiting.manager.domain.vo.permission.PermDetailVO;
import com.mazaiting.manager.domain.vo.permission.PermPageVO;
import com.mazaiting.mybatisplus.domain.vo.BasePageVO;
import org.springframework.transaction.annotation.Transactional;

import java.util.List;

/**
 * <p>
 * 权限表 服务类
 * </p>
 *
 * @author mazaiting
 * @since 2022-09-08
 */
public interface ISysPermissionService extends IService<SysPermission> {

    /**
     * 权限分页列表
     *
     * @param queryParams 权限查询条件
     * @return 分页数据
     */
    BasePageVO<PermPageVO> listPermPages(PermPageQuery queryParams);

    /**
     * 新增权限
     *
     * @param permForm 权限
     * @return true: 新增成功; false: 新增失败
     */
    @Transactional(rollbackFor = Exception.class)
    boolean save(PermForm permForm) throws BusinessException;

    /**
     * 更新权限
     *
     * @param permForm 权限
     * @return true: 更新成功; false: 更新失败
     */
    @Transactional(rollbackFor = Exception.class)
    boolean update(PermForm permForm) throws BaseException;

    /**
     * 删除权限
     *
     * @param ids 权限列表
     * @return true: 删除成功; false: 删除失败
     */
    boolean deleteByIds(String ids);

    /**
     * 权限<->有权限的角色集合
     *
     * @return 权限列表
     */
    List<SysPermission> listPermRoles();

    /**
     * 刷新Redis缓存中角色菜单的权限规则，角色和菜单信息变更调用
     *
     * @return true: 刷新成功; false: 刷新失败
     */
    boolean reloadPermRolesRules();

    /**
     * 根据权限 ID 获取权限详情
     *
     * @param permissionId 权限 ID
     * @return 权限详情
     */
    PermDetailVO getDetailById(Long permissionId) throws EmptyObjectException;
}
